home *** CD-ROM | disk | FTP | other *** search
/ L' Effet Pommier 3 / L'Effet Pommier - Volume 03.iso / Programmation / Text Editor Patches folder / Text Editor Patches / Text Editor Patches.rsrc / TEXT_128_TEXThelp.txt < prev    next >
Encoding:
Text File  |  1996-02-12  |  16.3 KB  |  270 lines

  1.     
  2. This application applies various patches to other applications or to desk accessories.  This approach gives more control over conflicts and memory bloat than extending application behavior by adding extensions to the system.
  3.  
  4. The patching process adds certain resources to the application.  No existing resources are modified, so it is easy to remove the patches if desired.
  5.  
  6.  
  7. Installation    
  8.  
  9. If you use GateKeeper, turn it off before using the patcher.  Some other virus detection programs might also think that what the patcher does is suspicious.  Disinfectant wonΓÇÖt complain.
  10.  
  11. Set the checkboxes the way you want them, then click the Patch button.  You will see a standard directory dialog box, which you should use to select the application you want to modify.  If all goes well, then in a few seconds you will see an alert saying that the patches have been applied successfully.
  12.  
  13. If you should change your mind about the optional settings, just change the checkboxes and patch again.  It is not necessary to unpatch first.  Any patches that are unchecked will automatically be removed.
  14.  
  15. The Unpatch button removes all of my patches from a selected file, regardless of the checkbox settings.
  16.  
  17.  
  18. Compatibility    
  19.  
  20. The patches have not been tested with System 6, and definitely are not safe to use without MultiFinder.
  21.  
  22. These patches are not compatible with PopUpFuncs, because it uses the same mechanism to add features to an application.  If such a product is installed, the patcher will warn you, and you should normally decide not to do the patch.
  23.  
  24. The patches reportedly are compatible with CMaster, except that the word wrapping icon will fail to appear.
  25.  
  26. If you use ClickChange, it may prevent the word wrap icon from appearing unless you exclude the patched applications from ClickChange.
  27.  
  28. If you use the ΓÇ£Simple TermΓÇ¥ tool in ASLEdit+, you probably will not want to use the matched pair patches, because ΓÇ£Simple TermΓÇ¥ does not support the arrow keys.
  29.  
  30. The page up and down patch behaves a bit strangely in DiskTop 4.5.  Namely, the thumb of the scroll bar may jump to an incorrect position, depending on where you left the mouse cursor parked.
  31.  
  32. I hear that the Windows patch does not work in EndNote Plus.
  33.  
  34.  
  35. Distribution    
  36.  
  37. These Text Editor Patches and this installer are copyrighted freeware.  They may not be sold or offered for sale, or included with another software product offered for sale, except with the express written permission of the author.  They may be redistributed, so long as they remain unchanged.  Of course, if you want to send me some money for it, you can.
  38.  
  39. You should not upload a patched version of a copyrighted application to any BBS without permission from the author of the application.
  40.  
  41. This program is provided as is, and is not guaranteed.
  42.  
  43.  
  44. AuthorΓÇÖs Address    
  45.  
  46. E-mail:
  47. CompuServe: 76367,2271
  48. America Online: JWWalker
  49. Internet: jwwalker@kagi.com
  50.  
  51. Hard mail:
  52. James W. Walker
  53. 766 S. Nardo Ave. #C9
  54. Solana Beach, CA 92075
  55.  
  56.  
  57. Acknowledgements    
  58.  
  59. Thanks to Larry Gerndt for the idea for THINK Link, and to Susan Lesch for beta testing and interface advice.  The Emacs Keys patch is by Adolfo Villafiorita.  A set of TeX patches was contributed by Juan L. Varona.
  60.  
  61. ┬á    
  62. The Word Wrap Patch    
  63.  
  64. Two of the nicest free text editors, BBEdit Lite and ASLEdit+, lack automatic word wrapping, as does the text editor built into THINK C.  So I designed a hack that adds a simple form of word wrapping to these editors.
  65.  
  66. When the patch is installed, each title bar of an editing window will contain a small icon indicating whether the word wrapping feature is on or off.  Click on the icon to change its state.  When word wrapping is on, then when the insertion point gets close enough to the right edge of the window, the next space character will be changed into a return character.  If you happen to type a very long word near the margin, or if you type fast on a slow machine, it is possible that you will type past the margin.  This is not a perfect word-wrapping method, but it is the best I can do without access to the applicationΓÇÖs internal data structures.
  67.  
  68. You can prevent an individual space character from being turned into a carriage return by holding down the shift key as you type it.
  69.  
  70. This patch can also be used with a DA editor, such as the DA form of ASLEdit+, if the DA has been installed directly into an application or has been ΓÇ£application-izedΓÇ¥ under System 7.
  71.  
  72.  
  73. The Page Up and Down Patch    
  74.  
  75. For text editors that do not implement the page up and page down buttons on the extended keyboard, this patch converts those keystrokes into the equivalent clicks on the vertical scroll bar.  If the window happens to contain more than one vertical scroll bar, the patch might click the wrong one.
  76.  
  77.  
  78. The SimpleText Power Pack    
  79.  
  80. This is a package of my favorite patches for SimpleText: Color Menu, Windows Menu, SimpleText Style Save, and SimpleText Picture Paste.  See their individual descriptions below.
  81.  
  82.  
  83. The Pair (), [], {} Patch    
  84.  
  85. Generate parentheses, brackets, and braces in pairs.  For instance, if you type a left parenthesis, then a right parenthesis and left arrow will also be inserted for you, so that the insertion point will be poised between the matched pair.
  86.  
  87.  
  88. The Singles Patch    
  89.  
  90. When using one of the pairs patches above, sometimes you want to type the left member of the pair all by itself.  This patch allows you to do so by pressing the control key as well as the usual keys.  For instance a left parenthesis would be control-shift-9, assuming the U.S. keyboard layout.
  91.  
  92.  
  93. The Forward Delete Patch    
  94.  
  95. This patch implements the forward delete key on extended keyboards by changing it to a right arrow followed by an ordinary delete.
  96.  
  97.  
  98. The Windows Patch    
  99.  
  100. This patch adds a Windows menu to an application that lacks one, such as Finder or SimpleText.  Remember that you will not be able to patch Finder while it is running.  Either quit the Finder, if you know how to do that, or boot from a different startup disk.
  101.  
  102.  
  103. The Stationery Menu Patch    
  104.  
  105. This patch adds a menu that lists stationery files (or, really, any frequently-used type of files) for an application.  When you choose the last item on the menu, named Setup, you get a dialog in which you can choose the menu title.  In this dialog, there is also a button named Specify.  Click Specify, and in the resulting directory dialog, choose an example of the type of file you want to list.  Then all the files in the same folder with the same type as that file will be listed in the menu.  This patch will probably not work in applications that are not AppleEvent-aware, but these days most are.
  106.  
  107.  
  108. The Color Menu Patch    
  109.  
  110. This patch adds a color menu to SimpleText, for adding color as a text style.  It may also work on other editors that edit styled text and have the same 32K limitation, but I canΓÇÖt think of any other such editor that lacks a color menu.
  111.  
  112. There is one problem with how it works:  When you apply a color, the selection flashes as the underline style is applied and removed.  This is just a strange way for my patch to convince SimpleText that the text has been modified, so that SimpleText wonΓÇÖt neglect to save the changes to disk.
  113.  
  114.  
  115. The SimpleText Picture Paste Patch    
  116.  
  117. People are always wondering why you canΓÇÖt just paste a picture into a SimpleText document.  Well, now you can.  A few caveats:
  118. 1. You canΓÇÖt paste a picture into an untitled document.  If you have not saved the file to disk, attempting to paste a picture will just get you a beep.
  119. 2. When you paste a picture, it saves the picture to the resource fork of the document.  However, the change to the text, an option-space character to mark the vertical position of the picture, is not saved.  If you then closed the window without saving, the file would be in a somewhat inconsistent state.
  120. 3. It attempts to paste enough returns after the option-space to leave room for the picture, but you may need to make adjustments.  If such editing erases the picture, the easiest way to make the picture come back is to slightly resize the window.
  121.  
  122. Besides an untitled document, there are a couple of other things that could cause a beep:
  123. 1. An existing PICT resource could not be moved, perhaps because its ΓÇ£protectedΓÇ¥ flag is set or because there was not enough memory in SimpleTextΓÇÖs partition.
  124. 2. A new PICT resource could be added, perhaps because the disk is locked or full.
  125.  
  126.  
  127. The SimpleText Style Save Patch    
  128.  
  129. I was bothered by the fact that when you save a file in SimpleText, the style changes do not get written to disk.  They do get written when you close the file, but I got into trouble by stuffing a file while it was open for editing.  So I wrote this patch to ensure that as soon as you hit ΓÇ£SaveΓÇ¥, the style changes will be written to disk.
  130.  
  131.  
  132. The Pair $$ Patch    
  133.  
  134. Generate dollar signs in pairs as with the other pairs patch, for those typing TeX source code.
  135.  
  136.  
  137. The Emacs Keys Patch    
  138.  
  139. For those whose fingers were trained by Emacs, this translates some of the most common emacs keystrokes into keystrokes that are understood by BBEdit.  The code was contributed by Adolfo Villafiorita.  The keystrokes are:
  140.  
  141. ^A        beginning of line
  142. ^E        end of line
  143. ^F        forward character
  144. ^B        backward character
  145. ^P        previous line
  146. ^N        next line
  147. ^D        forward delete char
  148. ^K        kill to the end of line
  149. ^V        next page
  150. OPTION V  previous page
  151.  
  152. The control-K keystroke is translated into a sequence of 3 keystrokes (cmd-shift-right arrow, shift right arrow, cmd-x) so it is somewhat slow.  Control-A and control-E are translated into the standard Macintosh keystrokes command-left-arrow and command-right-arrow, so applications which fail to handle the latter keystrokes will also fail to handle control-A and control-E.
  153.  
  154.  
  155. The TEClip Patch    
  156.  
  157. Some applications that use monostyled text do not do a good job of keeping their internal clipboard synchonized with the system clipboard.  The symptom is that what you paste is not always what you copied to the clipboard.  In particular I wrote this to fix problems with the Retriever Light DA, but other programs may benefit.
  158.  
  159. For programmers:  This patches TECopy, TECut, and TEPaste.  On the tail of TECopy and TECut it calls ZeroScrap and TEToScrap.  On the head of TEPaste it calls TEFromScrap.
  160.  
  161.  
  162. The HyperCard Cursor Patch    
  163.  
  164. For some reason, the text cursor in HyperCard, prior to version 2.2, had its ΓÇ£hot spotΓÇ¥ in an unusual place, making it more difficult to select some text.  The patch puts the ΓÇ£hot spotΓÇ¥ back in the normal position.  If you have version 2.2 or later, you do not need this patch.
  165.  
  166.  
  167. The Bell for MATLAB Patch    
  168.  
  169. I wrote this one so that I could make a procedure in Student MATLAB sound a beep.  When a procedure types out a control-G character (ASCII BEL) this patch replaces the character by a beep.
  170.  
  171.  
  172. The ASL Font Patch    
  173.  
  174. Change the default font used in ASLEdit+ from ASLFont+ to Monaco.
  175.  
  176. An ASLFont+ patch is provided for personal use only.  You should not change the default font of ASLEdit+ if you have any intention of using KanjiTalk or the ASLFont+.  Although you can set the font to ASLFont+ even with the patch in place, that font choice will not be respected the next time you open the document.
  177.  
  178. If you want ASLEdit+ to use a different default font than Monaco, you will have to use ResEdit either on the patched application or on this installer.  Edit the 'JWfn' resource.  It contains a length byte followed by a font name.
  179.  
  180.  
  181. ΓÇó Complete TeX Patch    
  182.  
  183. These are several patches designed to be used with text processor to type TeX source code. We MUST INSTALL ONLY ONE OF THEM, according the language of the keyboard of our Macintosh and the method that we want to use to type accents.
  184.  
  185. With these patches, we generate a lot of useful shortcuts for TeX:
  186.  
  187. 1.- We write Greek letters by using the option (or option + shift for capitals) at same time that the similar Roman letter. This is also employed to type several frequent mathematical symbols (\nabla, \partial, \hbar, \emptyset \aleph, \times).
  188.  
  189. 2.- We write vowels with accents pushing the accent key and the vowel. Also ├▒ (and ├æ), that is indeed written in TeX as an accent, is considered in this category. (Note, moreover, that in Spanish, it has its own key.)
  190.  
  191. 3.- We write non English characters (┬┐, ┬í, ├º, ├ƒ ├╕, ├ª, ┼ô, ├Ñ), some mathematical symbols (Γëñ, ΓëÑ, Γê₧, Γëá, ┬¼, ┬▒, ΓÇó, Γùè, ├╖, Γëê, Γêå, Γê½) and other special symbols (like ΓǪ, ┬⌐, ┬º, ┬╢, ΓÇá, etc.) by typing the corresponding keys in the Macintosh keyboard, as in any other application.  They are considered less important than Greek letters, and they will not be used if the position in the keyboard correponds to the one assigned to a Greek letter. But it is important to note that any useful letter in a language (for instance, ┬┐ in Spanish, ├ƒ in German, ├º in Catalan and French, etc.) has its own key in the corresponding keyboard, so they are not intercepted by any Greek letter.
  192.  
  193. 4.- We use the function keys F5, F6, F7 and F8 to generate (), [], {}, and || respectively. Using them with option we get \(\), \[\], \{\}, and \|\|. (In all these cases, the cursor appears in the middle.) And, finally, pushing also command, the selected text is surrounded by the corresponding delimiters.
  194.  
  195. 5.- Pushing the key with the number 4 (that, in many languages, also has the symbol $) at same time that command, we get $$ with the cursor in the middle. And pushing also option, the selected text is surrounded by two $.
  196. (Note: In AZERTY and QZERTY keyboards, pushing the key with the symbol $.)
  197.  
  198. These patches have been written (with the help of Jim Walker, the author of ΓÇ£Text Editor PatchesΓÇ¥, this patcher application) by:
  199.  
  200. Juan L. Varona
  201. Dpto. de Matem├íticas y Computaci├│n
  202. Universidad de La Rioja
  203. 26004 Logro├▒o, SPAIN
  204. e-mail: jvarona@siur.unirioja.es
  205.  
  206. For a complete explanation of the patch, read the TeX document TeXpatch.tex.
  207.  
  208.  
  209. The QWERTY TeX Patch (with \'{\i})    
  210.  
  211. This is ready for QWERTY keyboards, like U.S. and Spanish.
  212.  
  213. Actually, it works better with languages in which there are accents because, in such cases, the corresponding keyboards have dead-keys to type accented vowels. This happens, for instance, in Spanish.
  214.  
  215.  
  216. The QWERTY TeX Patch (with \'i)    
  217.  
  218. This is ready for QWERTY keyboards, like U.S. and Spanish.
  219.  
  220. It is mainly thought for keyboards where there are not dead-keys in a easily accessible position. So, typing, for instance,  the key with the symbol ┬¿ and it is generated the corresponding TeX code \". But, in this manner,  it is not possible to distinguish when the letter to accentuate is i, and it is not possible to put out the point over it. To solve this, we can redefine, for instance, the TeX accent \' as
  221.  
  222. \def\'#1{\if#1i{\accent"13\i}\else{\accent"13 #1}\fi}
  223.  
  224. and the point will be retired without problems. (Similar for accents \", \^, \` and \~ putting, instead of 13, the codes 7F, 5E, 12 and 7E respectively.)
  225.  
  226. Remember that, to properly use this patch, the previous TeX code MUST be included in each TeX file.
  227.  
  228.  
  229. The AZERTY TeX Patch (with \'{\i})    
  230.  
  231. This is ready for AZERTY keyboards, like French.
  232.  
  233. Actually, it works better with languages in which there are accents because, in such cases, the corresponding keyboards have dead-keys to type accented vowels.
  234.  
  235.  
  236. The AZERTY TeX Patch (with \'i)    
  237.  
  238. This is ready for AZERTY keyboards without dead-keys.
  239.  
  240. Remember that, to properly use this patch, the TeX code that we explain in The QWERTY TeX Patch (with \'i) section MUST be included in each TeX file.
  241.  
  242. However, we don't have any solution for ^ and ` French accents (for non-dead keys), because they are also useful TeX symbols. 
  243.  
  244.  
  245. The QWERTZ TeX Patch (with \'{\i})    
  246.  
  247. This is ready for QWERTZ keyboards, like German.
  248.  
  249. Actually, it works better with languages in which there are accents because, in such cases, the corresponding keyboards have dead-keys to type accented vowels.
  250.  
  251.  
  252. The QWERTZ TeX Patch (with \'i)    
  253.  
  254. This is ready for QWERTZ keyboards without dead-keys.
  255.  
  256. Remember that, to properly use this patch, the TeX code that we explain in The QWERTY TeX Patch (with \'i) section MUST be included in each TeX file.
  257.  
  258.  
  259. The QZERTY TeX Patch (with \'{\i})    
  260.  
  261. This is ready for QZERTY keyboards, like Italian.
  262.  
  263. Actually, it works better with languages in which there are accents because, in such cases, the corresponding keyboards have dead-keys to type accented vowels.
  264.  
  265.  
  266. The QZERTY TeX Patch (with \'i)    
  267.  
  268. This is ready for QZERTY keyboards without dead-keys.
  269.  
  270. Remember that, to properly use this patch, the TeX code that we explain in The QWERTY TeX Patch (with \'i) section MUST be included in each TeX file.